Skip to content

Add introductory guide to .NET source-build#5618

Open
mthalman wants to merge 2 commits into
dotnet:mainfrom
mthalman:mthalman-source-build-crash-course
Open

Add introductory guide to .NET source-build#5618
mthalman wants to merge 2 commits into
dotnet:mainfrom
mthalman:mthalman-source-build-crash-course

Conversation

@mthalman

Copy link
Copy Markdown
Member

Summary

.NET engineers need a consolidated introduction to the source-build philosophy and the downstream constraints it protects. This adds a teaching-oriented guide that explains why source-build exists before introducing its implementation details.

The guide covers:

  • source-build users, goals, and downstream guarantees;
  • the VMR build lifecycle and dependency provenance;
  • repository ordering and package-version lifting;
  • prebuilt detection, poisoning, and binary policy;
  • sequential and two-stage bootstrap workflows; and
  • source-build validation and CI dimensions.

The documentation index now links to the new guide.

Validation

  • Verified local Markdown files and heading anchors resolve.
  • Verified reference-style links are defined and used.
  • Checked the documentation diff for formatting errors.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 90e5bd72-0b40-4e76-b4e7-786378cbd0c7
@mthalman
mthalman marked this pull request as ready for review July 22, 2026 20:10
@mthalman
mthalman requested a review from a team as a code owner July 22, 2026 20:10
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 90e5bd72-0b40-4e76-b4e7-786378cbd0c7
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant